package org.dromara.admin.service;

import org.dromara.admin.domain.UserDetail;
import org.dromara.admin.domain.vo.UserDetailVo;
import org.dromara.admin.domain.bo.UserDetailBo;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.system.domain.bo.SysUserBo;
import org.dromara.system.domain.bo.SysUserPasswordBo;
import org.dromara.system.domain.bo.SysUserProfileBo;
import org.dromara.system.domain.vo.SysOssVo;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;

/**
 * 用户详细Service接口
 *
 * @author Lion Li
 * @date 2025-09-01
 */
public interface IUserDetailService {

    /**
     * 查询用户详细
     *
     * @param userId 主键
     * @return 用户详细
     */
    UserDetailVo queryById(Long userId);

    /**
     * 分页查询用户详细列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 用户详细分页列表
     */
    TableDataInfo<UserDetailVo> queryPageList(UserDetailBo bo, PageQuery pageQuery);

    /**
     * 分页查询租户列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 用户详细分页列表
     */
    TableDataInfo<UserDetailVo> queryPageTenantList(UserDetailBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的用户详细列表
     *
     * @param bo 查询条件
     * @return 用户详细列表
     */
    List<UserDetailVo> queryList(UserDetailBo bo);

    /**
     * 新增用户详细
     *
     * @param bo 用户详细
     * @return 是否新增成功
     */
    Boolean insertByBo(UserDetailBo bo);

    /**
     * 修改用户详细
     *
     * @param bo 用户详细
     * @return 是否修改成功
     */
    Boolean updateByBo(UserDetailBo bo);

    /**
     * 校验并批量删除用户详细信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Long[] ids, Boolean isValid);

    /**
     * 用户注销账号
     * @param userId 用户ID
     * @return
     */
    Boolean removeAccount(Long userId);

    /**
     * 根据注册信息添加详情信息
     *
     * @param sysUser 注册信息
     * @return 注册用户
     */
    UserDetailBo insertByRegisterBody(SysUserBo sysUser);

    /**
     * 切换用户账本状态
     *
     * @param userId 用户ID
     * @return 是否切换成功
     */
    Boolean toggleAccountStatus(Long userId);

    /**
     * 根据支付宝OpenId查询用户
     *
     * @param nickName     昵称
     * @param phone        手机号
     * @param alipayOpenId 支付宝OpenId
     * @return
     */
    UserDetailBo selectUserByAlipayOpenId(String nickName, String phone, String alipayOpenId);

    /**
     * 重置用户密码
     * @param userId 用户ID
     * @param password 密码
     * @return
     */
    int resetUserPwd(Long userId, String password);

    /**
     * 更新用户头像
     * @param userId 用户ID
     * @param oss 文件信息
     * @return
     */
    Boolean updateUserAvatar(Long userId, SysOssVo oss);

    /**
     * 修改用户基本信息(sys_user表)
     * @param profile 用户信息
     * @return
     */
    int updateProfile(SysUserProfileBo profile);

    /**
     * 校验登录用户是否实名认证
     * @param userId
     * @return
     */
    Boolean isRealName(Long userId);

    /**
     * 修改用户状态
     * @param userId
     * @return
     */
    int updateUserStatus(Long userId);

    /**
     * 资方提现后修改用户余额
     * @param userId
     * @param balance
     * @return
     */
    Boolean updateBalance(Long userId, BigDecimal balance);
}
